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‘¢ 133 DECLARATIONS 
(3) 1 VAXSEMULATE = Etre Path into Emulator 
3} i 4 VAX$ MULAT FPD = Alternate Entry Path into Emulator 
spa a 
; ; Di TaBl 
(8) 3 MPCS = Exception handler for CMPC35 instruction 
$393 794 CMPC5 = Exception handier for CMPCS instruction 
(13) 937 LOCC = Except ton handler for LOCC instruction 
ommon Exit Pat or VAX$xxxxxx Routines 
(34) 1953 C E Path f Ax$ R j 


| 

| 
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pase ption of instruction=specific routines 
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0000 
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BOOT_SWITCH = 1 
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\d NDITIONALS 


-NOSHOW CO 
TITLE BOR Te ONRATE - Subset VAX-11 Instruction Emulator for VMB 
-IDENT /V04-000/ 


j saeneneeeueerennerenereeeneeuenesenenenetenenetenceerteceeneqenetseensetens 


COPYRIGHT (c) 1978, 1980, 1982, 1984 
DIGITAL EQUIPMENT CORPORATION, ° MAYNARD. MASSACHUSETTS. 
ALL RIGHTS RESERVED 


brz3: I$ cyent eee UNDER A LICENSE AND MAY BE USED AND gt ht 
meee DANCE WITH THE TERMS OF SUCH ph AND WITH THE 


NN wM 


® 
® 
® 
® 
® 
® 
® 
® 
co HER torn * 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 
TRANSFERRED. * 
® 
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
*® 
® 
® 
® 
® 
® 
*® 
* 


AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 
CORPORATION. 


DIGITAL ASSUMES NO RESPONS 
SOFTWARE ON EQUIPMENT WHIC 


FOR THE USE OR — OF ITS 


BILITY 
IS NOT SUPPLIED BY DIGITAL 


I 
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. . a . . . . . 7 . 
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§ ennadennensnerereneenenseenseneronnseneeneseorenennnnqancesaeseneneeeasntes 
+ 
Facility: 
VAX=-11 Instruction Emulator 
Abstract: 
This is the main body of the instruction emulator that supports 
the instructions that are not a part of the microVAX architecture. 
The current design calls for support of the otrine se instructions 
(including CRC), the decimal instructions, and EDIT 
This routine performs the following steps. 


o Moves operands from the exception stack to registers in an 
instruction-specific manner 


o Calls an instruction-specific subroutine to do the actual work 


If errors occur along the way, those errors are reflected to the 
user as exceptions. 


Environment: 
These routines run at wy access mode, at ~ IPL, and are AST 
4 e 


reentrant. The routine starts execution int access mode and 
at the IPL at which the instruction executed. 


BOO! 
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3; Author: 


oo 


OOOOCOoCoo 
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Lawrence J. Kenah 
Creation Date 

17 August 1982 
Modified by: 


v01-011 LJK0041 Lawrence J. Kena 16-Jul-1984 
Clear FPD in saved PSL at VAXSEMULATE _FPD entry so that 
next instruction can execute correctly. 


v01-010 “yy Lawrence J. Kenah 5-Jul-1984 
Set R2 and R4 unconditionally to zero in EDITPC routine 
to allow the storage of FPD flags and similar data. 


v01-009 LJK0026 Lawrence J. Kenah 19-Mar-1984 
Perform final cleanup pass. Eliminate xxx_UNPACK routine 
references. Add C-bit optimization to MOVP. 


v01-008 LJK0010 Lawrence J. K 88-Nov-1983 
Eliminate code in EXIT EMULATOR spath that uncend) t tonal ly 
clears the T-bit and conditionally sets the TP-bit. The 
TP=bit is handled by the base hardware. 


v01-007 KOM0088 Kathlee 20-0c t-1983 
Make branches to VAXSREFLECT. 10. vMS into jumps, so that 
the bootstrap emulator will Tink without truncation errors 
until that routine is finished. 


Oooo 


ooooo 


v01-006 KDM0003 Kathleen D. Mors 18-Apr-1983 
Generate abbreviated VAXSEMULATE. _FPD for ther bootstrap 
emulator. 

v01-005 LJK0006 Lawrence J. Kenah 16-Mar-1983 
Generate case tables with macros. Allow subset emulator 
for bootstrap instruction emulation. 

v01-004 KDM0002 athleen D. Morse 16-Mar-1983 

Fix fourth ond fifth operand fetches for SUBP6, ADDP6, 

MULP and DIVP 

v01-003 KDM0001 athleen D. Morse 04-Mar-1983 
Longword align a caametian handler entry points. 

v01-002 LJK0005 Lawrence J. Kenah 15-Nov-1982 


Use hardware aids provided by microVAX architecture revision. 
Exception is now reported in caller's mode. Operands are parsed 
and placed on the exception stack as exception cae 


v01-001 LJK0002 Lawrence J. Kenah 17-Au 5 
Original version using kernel mode exception Aten OPCDEC 
exception vector. 
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DECLARATIONS |» instruction Emulator for "Br Sep=1S8e bb:asio8 FEMULAS. cREIVANGMULAT mars? 29° By 
. SUBTITLE DECLARATIONS 
; Include files: | 
SOPDEF ; Values for instruction gpocodes 
SPSLDEF : Define bit fields in P 


-NOCROSS 3; No cross reference for these 


OOoOoooooooooooooooooo 
SOoOoooooooooooooooooo 


COOCOCOCOOSOCOOCOCOOSOOCOS SSO SSS SOSSSO COSCO SCSOOCOSOOOOO OOOO OOOO OOOOoOOO 


- ENABLE SUPPRESSION ; No symbol table entries either 
PACK_DEF ; Stack usage when restarting instructions 
STACR_DEF ; Stack usage for original exception 
«DISABLE SUPPRESSION ; Turn on symbol table again 
«CROSS 3; Cross reference is OK now 

3; Macro definitions 

BASE «MACRO INIT_CASE_TABLE SIZE,BASE ,ERROR_EXIT 

REPT 


SIZE 
-WORD ERROR_EXIT-BASE 
-ENDR 


ZENDM INIT_CASE_TABLE 


| 
| 
-MACRO  CASE_TABLE_ENTRY OPCODE »~ | 
ROUTIN 

FPD ROUTINE, ~ | 

| 


BOOT _FLAG 
SIGN EXTEND OP$_‘OPCODE | ...OPCODE 
.. OFFSET = ...0PCOBE - este BASE 
IF NOT _ DEFINED b0pT. SQITCH 


E = 
«EXTERNAL VAXS OPCODE 


# msi” “FPD ROUTINE = FPD _CASE_TABLE_BASE 
: IF JDENTICAL <BOOT_FLAG>,BOOT 
EXTERNAL VAX$* OPCODE 


= CASE_TABLE BASE + <2 * ...0FFSET> 
- WORD ROUTINE - CASE_TABLE_BASE 


ROUTIN LE BASE | 

= FPD_CASE_TABLE BASE + <2-* .,.OFFSET> | 
| 

| 

| 

| 


~ENDC 
-ENDM = =CASE_TABLE_ENTRY 


; External declarations for exception handling 


COOOCCOOOCOOSOOCOOSOOOCOSOOOOSOOOSOOSOSOSCOOOSOSOOOOOOOOOOOCOOODOOOOOOOCOO 


SOOCCOCOCOSOOCSOSOSOOSOSOSOOSOSOSOSO OOOO OOSOSOSOSOOSOSoOoOOoOSO 
a dd dd dd 


SSSI NSN DS DS DS DDD DDD TTT EB BS BE EE ENN NII III PPPONOPOPonons— 
DONA OOO NA NEW  O OO NA MEW 0 OD NA UE WWI O OONOAU EWN OOONOUSWWN—0O0 


SOOQoooooooooooooooooooooooooocooooooooSo 


- DISABLE SLOBAL 
» EXTERNAL VAX$_OPCDEC, - 
VAX$_OPCDEC_FPD 


- 


seERAN SAT? Untrwetton mutator tor -SEEIES SAGE UAITE SETEALOA PRs mans MOP ch] | RE 
] 9 ; PSECT Declarations: 
: } § » DEFAULT DISPLACEMENT , WORD 
soll ! : -PSECT _VAXSCODE PIC, USR, CON, REL, LCL, SHR, EXE, RD, NOWRT, QUAD 
0000 186 «NOSHOW CONDITIONALS 


vine ae 
v04-000 


ntry Path into Emulator -SEP-19 0:45: EMULAT.SRCJVAXEMULAT.MAR; 1 
: - SUBTITLE VAXSEMULATE = Entry Path into Emulator 
Functional Description: 


C 11 

VAX=11 Instruction Emulator for 1 math 4:32:98 er Aes Macro V04-00 Page § 
TE 4 8 (3) | 
| 


There are two different entries into this module. When a reserved 
instruction is first encountered, its operands are parsed by the 
hardware (or microcode, if you will) and placed on the stack as 
exception peronesers. fhe code at address VAXSEMULATE is then entered 
through the “xC8(SCB) exception vector. That routine dispatches to an 
instruction=specific routine called VAXS$xxxxxx (xxxxxx represents the 
name of the reserved instruction) after placing the operands into 
registers as required by VAXSxxxxxx. 


If an exception occurred during instruction emulation such that a 
reserved instruction executed again, this time with FPD set, then a 
different exception path is taken. fhe stack has a different (smaller) 
set of parameters for the FPD exception. A different : 
instruction=-specific routine executes to unpack saved intermediate 
state before resuming instruction emulation. 


The access mode and IPL are preserved across either exception. 
Input Parameters: 


Opcode of reserved instruction 

PC of reserved instruction (old PC) 

First operand specifier 

Second operand specifier 

Third operand specifier 

Fourth operand specifier 

Fifth operand specifier 

Sixth operand specifier 

Seventh operand specifier (currently unused) 
Eight operand specifier (currently unused) 
PC of instruction following reserved instruction (new PC) 
PSL at time of exception 


fPUuWnonn — | CO0OoO 
FOOnwwaloorveso 
PELE 
vuvvUVUVUUUUUUDU 
eee we ew www ww 
teesvpeeveereebee 


Notes on input parameters: 


1. The information that appears on the stack for each operand depends 
on the nature of the operand. 


-fx = Operand value 

-ax = Operand address ‘ 

-wx = Operand address (Register destination is stored in one's 
complement form. See VAXSCVTPL for details.) | 


2. The old PC value is not used unless an exception such as an access 
violation occurs and the instruction has to be backed up. 


3. The seventh and eighth operands are not used for any existing VAX-11 
instructions. Those slots in the exception stach frame are reserved 
for future expansion. 


4. The two PC parameters and the PSL are the only data that needs to 
be preserved once the instruction-specific routine is entered. 


FARO OD NAU ES WIN 9 OOD NAUE WN 0 OONAMU EWN 0 OODNAU EWA OOONOAULSWN—OOR mm 


BBE EAA WII PIPIDNINPININPININID 2 2 OP SS | MOOOOOCOOOCOOCOCOCOWOOOOOOOOOMWOR 


; 
: 
; 
; 
; 
; 
; 
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; Output Parameters: 


The operands are moved from the stack to general registers in a way 
that varies from instruction to instruction. Control is transferred 
to a specific routine for each opcode. 


Notes: 


There are several tables in the emulator that use the opcode as an 
index. We choose to interpret the opcode as a signed quantity because 
this recuces the amount of wasted space in the tables. In either case, 
there are 27 useful entries. 


OOoooooooooo 


OOoOQoooooooooooooooo 


Unsigned opcode 


OPCODE_BASE = CVTPS (value of 8) 
OPCODE_MAX = CVTLP (value of F9) 


TABLE_SIZE = 241 decimal bytes 
Signed opcode 


OPCODE_BASE = ASHP (value of F8 or -8) 
OPCODE_MAX = SKPC (value of 38) 


TABLE_SIZE = 67 decimal bytes 
The savings of more than 170 entries in each table justifies all 


of the machinations that we go through to treat opcodes as signed 
quantities. 


Bee Se Se Ge Se Se Se Se Ge Ge Ge Se Se Be Ge Se Ge Se Ge Ge Ge Se Se Se Se Se Ge Sete 


; Because the assembler does not understand sign extension of byte and 

; word quantities, we must accomplish this sign extension with macros. The 
; assignment statements that appear as comments illustrate the sense of the 
; macro invocations that immediately follow. 


OPCODE_MAX = OP$_SKPC ; Largest opcode in this emulator 
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CASEB OPCODE(SP) ,#OPCODE_BASE ,#<OPCODE _MAX-OPCODE _BASE> 


LOCOCO OCOOCOSOCOCOOS COCO OSOOSSOSOCOSOCCOOCOCOCOCOCOOOCOOOOOOOOOOOOOOO 


SOSOSCOSOOOCOOSOOSOSOOOOSOOOOSOOSOOSOOOSOSOOOC OOOO OOOOOOOOO 


APA AAAAAPIPIPIPOPINPIPIPIPIPYUDNINI|NIPUPYPIPPINIPPPIPOPNINOMONINY 
SOOOOOCOCO OOO O0000000 0000 
NOUS WN (OOD — OONAUSE -_ 

Sete ee Sete tee 


p SIGN_EXTEND OP$_SKPC , OPCODE_MAX 

0 ; We further restrict the table size and supported operations when we are 

G03 $84 ; TnstrucBions tovcentetbute to the enufatorso”” ve OMY Attew cereain string 

0 

3 OPCODE_BASE = OP$_CMPC3 ; Smallest (in signed sense) opcode 

SIGN_EXTEND OP$_CMPC3 , OPCODE_BASE | 
00000013 , CASE_TABLE_SIZE = <OPCODE_MAX = OPCODE_BASE> + 1 ; Define table size | 

0 -ALIGN LONG ; Alianment for exception vector 

VAXSEMULATE:: 

| 


A et SS Fe oe “ 
— 11 
soe LATE Ss struction Emulator for 16-SEP-1984 01:37: AX/VMS Macro V04-00 Page 
Vv i y Path into Emulator $73 E-1 obs 8 25:38 YEMULAT. SREIUAXEMULAT MAR: 1 . dy 
INIT _CASE_TABLE CASE_TABLE_SIZE,CASE_TABLE_BASE,10$ 

:; If we drop through the case dispatcher, then the fault was not caused 


; by executing one of the instructions Supported by this emulator. Such | 
; exceptions will simply be passed through to VMS. (In the ae i a eal | 


; there is no operating system to reflect the exception. We simply 


PUSHL #VAXS$_OPCDEC ; Store signal name 
PUSHL #13 ; Total of 15 longwords in signal array 


NNOFr Yr Yr rrr re 
2 OO 


:; Nothing else we can do 
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; - SUBTITLE VAXSEMULATE_FPD = Alternate Entry Path into Emulator 
: Functional Description: 


voe-000- vax 


zw 
ce 
cr 
> 


This routine is entered through the “XCC(SCB) exception vector when an 
instruction that is not a part of the microVAX architecture executes 
and the FPD bit is set in ine PSL. The software state that was 
preserved by each instruction must be restored and instruction 
execution resumed. Access mode and IPL are preserved across the 
exception occurrence. 


Before the yerious VAXSxxxxxx Cor VAXSxxxxxx_ RESTART) routines regain 
control, this dispatcher must retrieve the delta PC from wherever 

it was stored and place the stack in the same state that it is in 

when the normal (FPD bit not set) instruction dispatcher passes 
couerens to the various VAX$xxxxxx routines. The pictures below explain 


Input Parameters: 


OO(SP) = PC of reserved instruction 
O4(SP) = PSL at time of exception 


Output Parameters: 


The following picture shows the state of the stack after the dispatcher 
has executed its preliminary code but before control is passed back to 
instruction-specific execution. Note that this routine makes the 

stack look Like it does when a reserved instruction executes and FPD 

is not yet set. This is done to make the exception exit code independent 
of whet o a different exception exception occurred while the emulator 
was running. 


QOO(SP) = Return PC (Address of EXIT routine in this module) 
04(SP) = Unused placeholder (OPCODE) 
O8(SP) = PC of reserved instruction (old PC) 

12(SP) = Unused placeholder (OPE s 

16(SP) = Unused placeholder (OPERAND_ 2) 

O(SP) = Unused placeholder (OPERAND_3) 

4(SP) = Unused placeholder (OPERAND_4) 

8(SP) = Unused placeholder (OPERAND_5) 

2(SP) = Unused placeholder (OPERAND_6) 

6(SP) = Unused placeholder (OPERAND_7) 

40(SP) = Unused placeholder (OPERAND_8) 

44(SP) = PC of instruction following reserved instruction (new PC) 
48(SP) = PSL at time of exception 
Before this routine dispatches to opcode-specific code, it calculates 
fhe PC of the next instruction based on the PC of the reserved 


nstruction and the delta-PC een ty that was stored as part of the 
instruction's intermediate state. Note that the delta PC quantity 
delta PC = new PC = old PC 


is stored in the upper bytes of one of the general cqsisters. usually 
bits <31:24> of RO or R2. The registers RO through R3 are stored on 
the stack (in the space used for the first four operands when the 
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ATE bset VAX-11 ing Fruct ten are Dy for 1 3 P-1984 AX/VMS Macro V04-00 Page 
re VARSEMULAYE FPD eat toshace Emvte Pathe? Pa} O84 Boras som LEMON AY. cae SoANCMUCar mars? 22 
1 3 reserved instruction is first encountered) so that the same offsets 
4 : that were used to store the delta-PC can be used to retrieve it. 
4 a 
? 5 «ALIGN LONG ; Alignment for exception vector 
r 5 VAXSEMULATE_FPD:: 
ee : 
00000000'8F DD 4 4 PUSHL #VAX$_OPCDEC_FPD ; This is the signal na 
04 DD 7 ? 0 PUSHL #4 ; Signal array has four Tongwords 
00 C 4 : HALT ; Nothing else we can do 


~~ 
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Dispatch Tables SEP-1984 45: 


t38 Re . SUBTITLE Dispatch Tables 
440 : Functional Description: 


The CASE _TABLE_ENTRY macro assumes that the names of the respective 
case tables aré CASE_TABLE_BASE and FPD_CASE_TABLE_BASE. 


Notes: 


The case tables for the two CASEB instructions are built with the 
0 macros that are invoked here. Macros are used to guarantee that both 
3 saree contain correct entries for a selected opcode at the same 
Assumptions: 
0 
0 


In the following Lists, those FPD routines that do not have _FPD in 
their names use the same JSB entry point for initial entry and after 
restarting the instruction. In most of these cases, the rogtater state 
is the same for both starting and ag thy For the remaining cases, 
there is not enough difference between the two cases to justify an 

4 pbb be a ad point. (See VAXS$MOVTC for an example of this latter 
situation. 


The FPD routines that include _RESTART in their names have to do a 
certain amount of work to restore the intermediate state from the 
canonical registers before they can resume instruction execution. 


OOONO UE WN — OOONOUE wry 
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461 


- SAVE ; Remember current location counter 
; First generate table entries for the string instructions 


CASE_TABLE_ENTRY OPCODE=MOVTC,- 
ROUT INE=MOVTC,- 
FPD_ROUT INE=VAXSMOVTC 


CASE_TABLE_ENTRY OPCODE=MOVTUC,- 
ROUT INE=MOVTUC, = 
FPD_ROUT INE=VAX$MOVTUC 


CASE_TABLE_ENTRY OPCODE=CMPC3,- 
ROUT INE=CMPC5,- 
FPD_ROUTINE=VAXSCMPC3,~- 
BOOT_FLAG=BOOT 


CASE_TABLE_ENTRY OPCODE=CMPC5,- 
ROUTINE=CMPC5 ,- 
FPD_ROUTINE=VAXSCMPC5,- 
BOOT_FLAG=BOOT 


CASE_TABLE_ENTRY OPCODE=LOCC,- 
ROUTINE=LOCC, = 
FPD_ROUTINE=VAX$LOCC,- 
BOOT_FLAG=B00T 


CASE_TABLE_ENTRY OPCODE=SKPC,- 


DOOOOSOSOOSOOOOOSOSOSOOSOSOSOOOOOOOOOOOOOSOOoOO 
Owoc 


SOOCOCCOOOOOCOOCOC COC OOCOSOSOCO OOO OOOO OOOOOOOoOoOoOO 
MNVSOOOCSCOSOOSOOOWWWIWI AAW AAA AAAI AI IAAI AAAI 
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VAXSSKPC 


CASE_TABLE_ENTRY OPCODE=SCANC = | 
ROUTINE=SCANC,= 
FPD TROUT INE SVAXSSCANC | 


CASE_TABLE ENTRY SOUT HES SPANC, - 


CASE_TABLE_ENTRY OPC ODE =m mAtcnt,- 
FPD ROUT INE=VAXSMATCHC 


CASE_TABLE_ENTRY OPCODE=CRC,- 
ROUTINE=CRC,= 
FPD_ROUTINE=VAXSCRC 


; Now generate table entries for the decimal instructions 


CASE_TABLE_ENTRY OPCODE=ADDP4 ,- 
ROUT INE=ADDP4, = 
FPD_ROUT INE=VAXSADDP4 
} 


CASE_TABLE_ENTRY OPCODE=ADDPG - 
ROUT INE=ADDP6,- 
FPD TROUTINESVAXSADDP6 


CASE _TABLE_ENTRY OPCODE=ASHP,- 
ROUT INE=ASH 
FPD _ROUT INE =VAXSASHP 


CASE_TABLE_ENTRY OPCODE=CMPP3,- 
ROUT INE=CMPP$, - 
FPD_ROUTINE=VAXSCMPP3 


CASE_TABLE_ENTRY pga - 
ROUTINE=CM 
FPD "ROUTINES eVAXSCMPP4 


CASE_TABLE_ENTRY aA gd Ag - 
ROUTINE=CVT 
FPD TROUT INESVAXSCVTLP_” RESTART 


CASE_TABLE_ENTRY OPCODE=CVTPL .~ 
ROUTINE=CV 
FPD TROUT INES OUAXSCVTPL _RESTART 


CASE_TABLE_ENTRY OPCODE=CVTPS - 
ROUT INE=CVT 
FPD_ROUTINE= PVAXSCVTPS 


CASE_TABLE_ENTRY OPCODE= cyTPT 
ROUTINE=CVTPT,- 
FPD TROUT INES VAXSCVTPT RESTART 


PAA AWA AAAI IP POPUDIPINONININIDY SS 2 SS S"DOOTOOOOOOCOOWOOWONO 


@0.09.00900 00 09 G9 C9 0d Co Cd G9 GD: Od 00 OD Od Gd CD GD Cd OD GD GD OD Gd Od CD Cd CD OD OD CD CD CD CD OD OD OD CD CD CD CD C9 CD. 0D 09 0D C9 CD CD CD 0D 0D 0D 0D 0D 
PVP LV LULU DV DV LVLIULVSVIVSVIUSIUSUIUIVIVSIUSUSULVIVSIVSUSUSUSVSTS ISVS USSSA USS SISOS IOSIOSISISIOSISIOS SS SS 
OOD NA NE WWIN 9 OD NAME WIN O OD NIA UE WIN OO OD NAMES WN O ODNOAU EWN OOONIO 
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ree Dispatch Tables g- ae ts 7 84:25:93 EMULAT.S REQ VAXEMULAT.MAR; 1 = (3) 
3 CASE_TABLE_ENTRY OPCODE=CVTSP,- 
ROUTINE=CVTSP,= | 
, FPD_ROUTINE=VAXS$CVTSP | 
§ CASE_TABLE_ENTRY OPCODE=CVTTP,- 
ROUTINE=CVTTP,- 
: FPD_ROUTINE=VAXS$CVTTP_RESTART | 
60 CASE_TABLE_ENTRY op CODES DIVP,=- 
61 ROUT INE=DIVP, = 
¢ FPD TROUTINESVAXSDIVP 
8 CASE_TABLE_ENTRY OPCODE=MOVe - 
0 65 ROUT INE=MO 
0 66 FPD TROUT ING=VAXSMOVP 
0 68 CASE_TABLE_ENTRY OPCODE=MULP,- 
00 69 ROUT INE=MULP, = 
00 20 FPD TROUT INE=VAXSMULP 
00 326 CASE_TABLE_ENTRY OPCODE=SUBP4 - 
00 57 ROUT INE=SUB 
00 8 37 FPD_ROUTINE= PVANSSUBPS 
00 : 576 CASE_TABLE_ENTRY OPCODE=SUBP6,- 
90 577 ROUT INE=SUBP6, - 
00 8 378 FPD_ROUT INE=VAX$SUBP6 
+ 8 280 ; EDITPC always seems to find itself in last place 
0096 382 CASE_TABLE_ENTRY OPCODE= EDITPC.~ 
0028 58 ROUTINE=EDITPC,- 
00¢8 284 FPD_ROUTINE=VAXSEDITPC_RESTART 
oo000gse 586 »RESTORE ; Reset current location counter 


OOCOCoooccoco 
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FF PANINI ANIA AIS PIPIDIPNPININININD 2 SO | MQOOOOOCOOCOCOCOCOOOOOOOOOOWO 
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- SUBTITLE Description of instruction-specific routines 


: The instruction=-specific routines do similar things. Rather than clutter up 
; each routine with the same comments, we will describe the steps that each 


; routine takes in this section. 


The input parameters to each routine are identical. 


OPCODE (SP) - Opcode of reserved instruction 

OLD_PC(SP) - PC of reserved instruction 

OPERAND_1(SP) = First operand specifier 

Ie bE - Second operand specifier 

OPERAND_5(SP) = Third operand specifier 

OPERAND_4(SP) = Fourth operand specifier 

OPERAND_S(SP) = Fifth operand specifier 

ok re OE - Sixth operand specifier 

OPERAND_7(SP) = Seventh operand specifier (currently unused) 
OPERAND _8(SP) = Eight operand specifier (currently unused) 
NEW _PC(SP) - PC of instruction following reserved instruction 
EXCEPTION_PSL(SP) = PSL at time of exception 


The routine headers for the instruction-specific routines in this 
module will List the input and output parameters in symbolic form : 
only. The VAX$xxxxxx routines in other modules in the emulator contain 
ol, sare meanings of the various operands (parameters) to the 
routines. 


Outline of execution: 


Notes: 


The operands are loaded into registers as required by the instruction 
spect se Feuttaae. Routine headers for each routine contain detailed 
escriptions. 


A routine of the form VAXSxxxxxx (where xxxxxx is the instruction 
med se cotles to perform the actual work indicated by each 
nstruction. 


Common exit code executes to allow the condition codes returned by the 
VAX$Sxxxxxx routines to be passed back to the code that generated the 
original exception. 


The following routines are constructed to be reasonably fast. In 
particular, each instruction has its own separate routine, even though 
several instructions differ only in the instruct ion~spec i fic routine 
to which final control is passed. Rather than share this common code 
at the expense of another dispatch on opcode, we shoose to duplicate 
the common code. 
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Z . SUBTITLE CMPC3 = Exception handler for CMPC3 instruction 
Input Parameters: 


- len.rw 
- srciaddr.ab 
- src2addr.ab 


SS LR LR LE LOL LE LL 
ee et ee ee ee ee ee 


NEW_PC(SP 

EXCEPTION_PSL(SP) 
Output Parameters: 

RO<15:0> = Len.rw 

R1 - srciaddr.ab 

R3 - srcdaddr.ab 
Implicit Output: 


RO<31:16> - 0 
R2 - UNPREDICTABLE 


Be Ge Ge Ge Ge Se Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge 


OOCCCOCSCOCOC COCO COCO O OOOO OOOOOOOOoO 


COOCoCoCoCOOCOoooOooooooooooCoooQooooQoQooQooQooooooooo 
COWOOOOVOOU TOIT VTTVTVTVCTVTVTVTVTVTVCVTVTVUVTVVVTCC"00C0000"0C7 9 
SSS Se eeeeeTrTwtwTs 
50.09.0969 69 09 09 69 09 09 09 SI NIN NINN NNN NDP PPP AAA AA MAI 
SOONAUE WN O OONOAUE WN O OD NAUE WN OO OONOUS Wn "O0 


CMPC3: 
50 08 AE MOVZWL OPERAND_1(SP),RO 3; RO<15:0> <= srclen.rw 
51 OC AE 00 00 MOVL OPERAND_2(SP),R1 : RI <- srciaddr.ab 
53 10 AE 3 MOVL OPERAND_3(SP) ,R3 ; R3 <- src2addr.ab 
0 ; Now that the operands have been loaded, the only exception parameter 
0 ; other than the PC/PSL pair that needs to be saved is the old PC. However. 
0 3; there is no reason why the state of the stack needs to be altered ane ae 
3 save two instructions if we leave the stack alone. 
OO80'CF 9F 00 PUSHAB VAXSEXIT_EMULATOR ; Store the return PC 
FFBO' 31 004 BRw VAXSCMPC3 ; Do the actual work 
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- SUBTITLE 


Input Parameters: 
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P 
EMULAT.SRCJVAXEMULAT.MAR; 1 
CMPCS = Exception handler for CMPC5 instruction 


- srcilen.rw 

- srcladdr.ab 
- fill.rb 

- srcélen.rw 

- srcdaddr.ab 


NEW _PC(S 
EXCEPTION_PSL(SP) 


Output Parameters: 


RO<15:0> 
RO<23: 16> 


R1 
ageraste 
R 


Implicit Output: 


srclen.rw 
fill.rb 
srcaddr.ab 


srcelen.rw 
srcdaddr.ab 


RO<31:24> - peneers eke 


R2<31:16> 


ROTL #16, OPERAND 3(SP) ,RO 3 RO<23:16> <- fill.rb 
MOVW  OPERAND_1(SP),RO t RO<15:0> <= srcllen.rw 
PERAND_2(SP) ,R1 3; RI <- srciladdr.ab 
MOVZWL OPERAN ~0 {$8} -Re : oo <- src2len.rw 
OPERAND_5(SP),R zh <sca- srcdaddr.ab 


3; Now that the operands have been loaded, the only exception parameter 

3 other than the PC/PSL pair that needs to be saved is the old PC. However, 
3; there is no reason why the state of the stack needs to be altered and we 
3 save two instructions if we leave the stack alone. 


PUSHAB VAXSEXIT_EMULATOR ; Store the return PC 
BRw VAXSCMPC5 ; Do the actual work 


! 
4s 
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SUBTITLE LOCC = Exception handler for LOCC instruction 
; Input Parameters: 
OPCODE (SP) 
OL 


rn len.rw 
= addr.ab 


YR RRR RAO Rw 
NOnnnonnunn 
vuvvVvUUU,YU 
www yerwrww 


NEW_PC( 

EXCEPTION_PSL(SP) 
Output Parameters: 

RO<15:0> = Len.rw 

RO<23:16> = char.rb 

R1 - addr.ab 
Implicit Output: 


RO<31:24> = UNPREDICTABLE 


964 

+44 LOCC: 

967 ROTL #16,O0PERAND_1(SP),RO 3 RO<23:16> <= char.ab 

968 MOVW OPERAND_2(SP),R : RO<15:0> <= Len.rw 

14 MOVL OPERAND_3(SP),R1 3; RI <- addr.ab 

971 ; Now that the operands have been loaded, the only exception parameter 

ars 3; other than the PC/PSL pair that needs to be saved is the old PC. However, 
973 ; there is no reason why the state of the stack needs to be altered and we 
are 3; save two instructions if we leave the stack alone. 

976 PUSHAB VAXSEXIT_EMULATOR ; Store the return PC 

977 BRW VAX$LOCC 3; Do the actual work 
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SUBTITLE Common Exit Path for VAX$xxxxxx Routines 
Functional Description: 
This is the common exit path for all instruction-specific routines. 
The condition codes returned by the VAX$xxxxxx routine are stored in 
s 


the exception PSL and control passed back to the instruction stream 
that executed the reserved instruction. 


2 090900 00 CD CD CD 0D 0D 


; Input Parameters: | 
PSL contains condition code settings from VAX$xxxxxx routine. 


OPCODE (SP) - Opcode of reserved instruction 
OLD_PC(SP) - PC of reserved instruction 
OPERAND_1(SP) = First operand specifier 
oe SE bE - Second operand specifier 
OPERAND_3(SP) = Third operand specifier 
OPERAND_4(SP) = Fourth operand specifier 
D_5(SP) = Fifth operand specifier 
OPERAND_6(SP) = Sixth operand specifier 
OPERAND_7(SP) = Seventh operand specifier (currently unused) 
OPERAND 8(SP) = Eight operand specifier (currently unused) 
NEW PC(SP) - PC of instruction following reserved instruction 
EXCEPTION_PSL(SP) = PSL at time of exception 


eee eee ee eee el eleolelelololeololelololo) 
SINISE SSNS SA AAA AAA AAA MMIII 


Implicit Input: 


General registers contain architecturally specified values according 
to specific instruction that was emulated. 


Implicit Output: 


Control is passed to the location designated by “new PC’ with the 
condition codes as determined by VAX$xxxxxx. The EXIT routine also 
preserves general registers. 


; OPERAN 


VAXSEXIT eat 


‘OD GD GO GD CD C9 CD 09 C9 CS OD Od CD OD C9 GD OD Od OD GD CD CD 0D CO OD CD CD 0D CD00 0D: 
SODOANNNMNNO OOOO OOCOCOQOOCCOCCCOCOCOOCOOCOCOOCOOOOOOOOOOOOOoOO 
DOOOOOVOOOOOOOOOOOODOOOOOODODOOOSGOOWODODOOOVOOOOOOOOOOOOOO 
MRO ODNA NEW  O ODNAUE WN 0 OD NAUE WIN 0 ODNOU EWN OWOONOUEW 


RORY 2 3 ts 
SOC COCOOOOO OO OWBDOBWOWmmcno-~ 


ODOSOOCOSOOOCOSOOSOOOOSOOSOSOOSOOSOOOOOCOSOOOOOOOOOOOOOOOOOOOOOO 


SOOSGOCCOCCOOCSOOOCOCOOoOOOoOSCoOOCoOO 


7E «OC MOVPSL =-(SP) ; Save the new PSL on the stack 
; Note that the next instruction makes no assumptio-s about the condition 
; codes in the saved PSL. 
06 OO BE FO INSV (SP)+,#0,44,- 
2¢ AE 8 EXCEPTION_PSL (SP) ; Replace caved condition codes 
5E 28 CO 8 ADDL #NEW_PC,SP ; Adjust stack pointer (discard old PC) 
02 ° REI 3 Retur: 
8 


- END 


SesSanmiecpe=sepnieeesies stmeensacan Ge BRS CREREAEe POE ena D TTR a encoa 
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Symbol table “SEP=-1984 00:45:28 CEMULAT.SRCJVAXEMULAT.MAR; 1 (34) 
. OFFSET = £8000 OF OPS$_CVIGF = $8 33FD 
PCODE = 00 8 OP$_CVTGH = QOQ0056FD 
BOOT SWITCH = 00000001 OP$_CVTGL = QOO04AFD 
CASE_TABLE_BASE 0000004 R 02 OP$_CVTGW = 000049FD 
CASE_TABLE_SIZE = BR O88 13 OP$_CVTHB = 00 gear’ 
MPCS 0000 Hi R og OP$_CVTHD = QOOOF7FD 
cMPCS 44 OR 0 OP$_CVTHF = QOOOF6FD 
EXCEPTION < = 0000 3 OP$_CVTHG = 000076FD 
INCLUDE _CAPC = 00000000 OP$_CVTHL = ti era 
INCLUDE_CMPC5 = 00000000 OP$_CVTHW = 000069FD 
eae: * $e kon Bak vit? = $e 
PC = $000088 OP$_CVTLG = SO0SEED 
OP$_ACBD = 0000006F OP$_CVTLH = QOOO6EFD 
_ACBF = 0000004F OP$_CVTLP = Q00000F9 
OP$_ACBG = QOOO4FFD OP$_CVTPL = 00000036 
_ACBH = QOOO6FFD OP$_CVTPS = 00000008 
OP$_ADDD2 = 00000060 P$_CVTPT = 00000024 
OP$_ADDD3 = 00000061 OP$_CVTROL = 00000068 
OP$_ADDF 2 = 00000040 OPS_CVTRFL = 00000048 
OP$_ADDF3 = 00000041 OP$_CVTRGL = 00004BFD 
OP$_ADDG2 = Q00040FD OP$_CVTRHL = 00006BFD 
OP$_ADDG3 = 000041FD OP$_CVTSP = 00000009 
OP$_ADDH = 000060FD OP$_CVTTP = 00000026 
OP$_ADDH = 000061FD OP$_CVTWD = 00000060 
OP$_ADDP4 = 00000020 OP$_CVTWF = 0000004D 
OP$_ADDP6é = 00000021 OP$_CVTWG = 00004DFD 
ASHP = 000000F8 OP$_CViwWH = QOO06DFD 
OP$_CLRD = 0000007C OP$_DIVD = 00000066 
OP$_CLRF = 000000D4 OP$_DIVD = 00000067 
OP$_CLRG = 0000007C OP$_DIVF = 00000046 
_CLRH = 00007CFD OP$_DIVF = 00000047 
OP$_CMPC3 = 00000029 OP$_DIVG = 000046FD 
OPS$_CMPC5S = 0000002D OP$_DIVG = 000047FD 
OP$_CMP = 00000071 OP$_DIVH = 000066FD 
OPS_CMPF = 00000051 OP$_DIVH = 000067FD 
OPS$_CMPG = 000051FD _DIVP = HAs $4 
_CMPH = 000071FD OP$_EDITPC = 00000038 
OPS_CMPP3 = 00000035 _EMODD = 00000074 
OPS_CMPP4 = 00000037 OP$_EMODF = 00000054 
CRC = 00000008 OP$_EMODG = 000054FD 
_CVTBD = 0000006C OP$_EMODH = 000074FD 
OP$_CVTBF = 0000004C LOCC = Q000003A 
OP$_CVTBG = BR OR CED OP$_MATCHC = Boo po RFS 
OP$_CVTBH = 6CFD OP$_MNEG = 000000 § 
OP$_CVTDB = SG OPS_MNEGF = 0000005 
OP$_CVTOF = 000 99 6 OP$_MNEGG = 000052FD 
OP$_CVTDH = 000032FD OP$_MNEGH = 000072FD 
OP$_CVTDL = 0000006A OP$_MOV = 00000070 
CVT = sit 069 OPS_MOVF = 00000050 
OP$_CVTFB = 8p 00048 OP$_MOVG z 4 FD 
OP$_CVTFD = 00000056 OP$_MOVH = 88 FD 
_CVIFG = 000099FD OP$_MOVP = 0 Bons 
OP$_CVTFH = 000098FD OP$_MOVTC = 00 8 E 
OP$_CVTFL = 8 4A OP$_MOVTUC = F 
OPS_CVTFW = 49 OP$_MULD = 8 4 
OP$_CVTGB = 000048FD OP$_MULD = 65 


BOOSEMULATE 
Symbol table 


OP$_MULF 
OPS MULE 


VAXSEMULA PD 
VAXSEXIT AEMOLATOR 
VAX$LO we 
VAX$_OPCD 
VAXS~OPCDEC _FPD 


PSECT name 


$ABS 
_VAXSCODE 
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00 pote 
0045 
465) 
45FD 
00064FD 
0 tH 
00 8s 
Bb 
8 4's EE 
B803 FD 
090 eta 
0000088 
Book OE 
000006 
0000006 
44 $4594 
0000004 
+4 69 14 
0000435FD 
ppnpogeD 
0000635FD 
EL 
000000 
00000073 
aii 4 
000053FD 
000073FD 
00000000 
49 44 6 84 
00000038 
00000008 
0000000C 
00000010 
00000014 
00000018 
eeeeeeee ; 02 
eeereree 02 
00000000 RG. 02 
00000034 RG BS 
00000080 -. 0 
eaters 02 
etekeeee 4 00 
teereene 4 00 
ferme wre mame ncaa > 
H Psect synopsis ! 
Allocation PSECT No. Attributes 
00000000 <( 0.) 00 ¢ OO.) NOPIC USR CON ABS - LCL NOSHR NOEXE 
00000000 ( 8°} 83 ( 1.) NOPIC USR CON ABS LCL NOSHR’- EXE 
0000008C ( 140.) ca * PIC USR CON REL LCL SHR~ EXE 


cro V04-00 
REIV VAXEMULAT.MAR; 1 


sa ~ NOWRT NOVEC BYTE 


WRT NOVEC 
RD NOURT NOVE 


rage 30, 


BYTE 


C QUAD 
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Performance indicators ! 


' 
+< eon coa seas woenacae esaeoces + 


Elapsed Time 


nitialization :00:00. :00:01. 

Initializati 9 00:00:00.05 0:00:01.44 
Command processing 71 0:00: . 3 0: 3: 4.49 
Pass 409 0:00: 29 :00:39.56 
Symbol table sort 0 0:00: 9-6 :00:01.11 
Pass 2 131 0:00:05.51 :00: 4-89 
Symbol table output 19 0:00:00.15 :00:00.57 
Psect synopsis output § 00:00: 8-95 BF BD: 0.02 
Cross-reference output i SEG 0:00:00.00 
Assembler run totals 641 00:00:20.87 00:01:08.29 


The ye, set_ Limit was 1500 pages. 
824735 bytes_(162 pages) of virtual memory were used to buffer 
There were 30 pages of symbol table space allocated to hold 45 


141 pages of virtual memory were used to define 139 macros. 


Gadeeceeecoascosoeeoseceece 


Macro Library statistics 


Macro Library name Macros defined 


-$255$DUA28 : CEMULAT .OBJ JVAXMACROS .MLB; 1 3 
$255$DUA28: (SYSLIBJSTARLET.MLB;2 
TOTALS (all Libraries) 8 


518 GETS were required to define 8 macros. 
There were no errors, warnings or information messages. 
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' 
¢ eww er ene semen ee mecowr ener oscesce - 


he intermediate code. 
non-local and 1 local symbols. 
4755 source lines were read in Pass 1, producing 13 object records in Pass 


MACRO/LIS=L1IS$:BOOEMULAT/0BJ=0BJ$:BOOEMULAT MSRC$:BOOTSWT/UPDATE=(ENHS:BOOTSWT) +MSRC$:MISSING/UPDATE=(ENHS:MISSING) *MSRC$: VAXEMULAT/ 


-SE 
SE 


Se ~y 


abs 9 01:32:98 AX/VMS Macro V04-00 
P=1984 00:45:28 


Page $) 
EMULAT.SRC]VAXEMULAT.MAR; 1 (54) | 
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